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SPECIFICATION 

Electronic Version 1.2.8 
Stylesheet Version 1 .0 

System and Method For 
Supporting SNMP Managed 

Networks 

Cross Reference to Related Applications 

This application claims the benefit of United States provisional patent Application No. 
60/327,401 filed October 5, 2001, the disclosure of which is incorporated herein by 
reference. 

Background of the Invention 

[0001] The present invention relates generally to communication systems and, in 

particular, to systems for managing devices which make up the communications 
systems. More particularly, the present invention relates to systems and methods for 
establishing and implementing a management protocol for governing the 
management of the communications system devices. 

[0002] In their simplest form, all communications networks comprise a variety of 

individual network devices connected to at least one other such device. These devices 
then operate to transmit information to each other. As the size of networks has 
increased as well as the number of individual devices and device manufacturers which 
together make up the networks, there arose a need to enable management of the 
various devices from a location remote to the devices in question so as to facilitate 
uncongested, error-free transmissions. To this end, the Internet Architecture Board 
("IAB") in the late 1980 f s developed a set of tools, protocols, and a common database 
for general network management. Collectively, this standard was termed simple 
network management protocol ("SNMP"). 

[0003] 

An SNMP managed network comprises three main elements to perform its 
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management functions: at least one managed device; a network management system 
("NMS") for facilitating the various management functions, and at least one SNMP 
agent ("agent") for providing the interface to the managed devices. Examples of 
managed devices include bridges, hubs, routers, servers, etc. which can collect and 
store management information regarding their operation. Typically, agents are 
software modules which perform their tasks by residing on the particular device to be 
managed. Each agent typically maintains a local database of variables that describe its 
state and history and affect its operation. In this system, the NMS is operated under 
the control of a network manager, who is responsible for detecting and correcting 
problems that make communication inefficient or impossible and to eliminate the 
conditions that will produce the problem again. 

[0004] Specifically regarding the protocol itself, SNMP defines exactly how the NMS 

communicates with an agent. For example, SNMP defines the format of requests that 
the NMS sends to an agent and the format of that an agent returns. In addition, SNMP 
defines the exact meaning of each possible request and reply. SNMP further specifies 
that an SNMP message must be encoded using a standard known as Abstract Syntax 
Notation. 1 ("ASN.l"). SNMP enables two general types of management operations: 
"get" operations whereby device status, history and other attribute values (collectively, 
referred to as "objects") are retrieved from the managed device, and "set" operations 
whereby device objects are modified. According to standardized naming conventions, 
each object that can be retrieved or modified is given in a unique name. 
Correspondingly, any particular commands that specifies get or set operations must 
specify this unique object name. Typically, communications between the NMS and its 
agents use User Datagram Protocol ("UDP") services on the network to exchange 
messages. 

0005] Regarding the information exchanged, each agent is typically responsible for 
providing access to a local Management Information Base ("MIB") of objects that 
reflects the resources and activity at its managed device. The agent also responds to 
NMS requests to retrieve values from the local MIB and to set values in the local MIB. 
Each local MIB is a subset of the managed network MIB maintained at the NMS which 
relates to the managed objects for each managed device. One example of an object 
that can be retrieved is a counter that keeps track of the number of packets sent and 
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received over a link into the device; the network manager can then track this value to 
monitor the load at that point in the network. One example of an object that can be 
set is one that represents the state of a link. In this example, the manager may disable 
the link by setting the value of the corresponding object to a "disabled" state. 

[0006] Essentially, each local MIB is a set of named items that an SNMP agent 

understands. An additional feature of SNMP relates to asynchronous relay of 
information not specifically requested by the NMS. Upon occurrence of a significant 
network event, (e.g., device crash, reboot, excessive congestion, etc.) the event is 
defined in a local MIB module. When an agent notices that a significant event has 
occurred, it immediately reports the event to all management stations in its 
configuration list. This report is called a trap. 

[0007] Conventional implementations of SNMP require that each device supporting SNMP 
(virtually all known network devices support SNMP management) include a listing of 
the various managed objects associated with the device. The identified managed 
objects are then compiled into the local MIB by the SNMP agent. Unfortunately, the 
identification and listing of these managed objects is not generally of primary concern 
to the device developers. Consequently, the creating and coding of this listing is often 
delayed until late into the development process and often, erroneous or incomplete 
listings accompany the final device. These errors can then disrupt or prevent efficient 
SNMP management of the device. Therefore, there is a need in the art of SNMP 
management systems for a system and method for ensuring the complete and 
accurate listing of managed objects. 

[0008] 

Further, in responding to a get or set request, the agent examines its local MIB for 
the requested variables and, if found, provides them to the NMS. The local MIB is, in 
turn, populated based upon variables provided by the managed device. However, in 
some instances, all requested variables are not supported by the managed device, or 
are otherwise irretrievable by the agent. Unfortunately, some SNMP agents do not 
respond to partially populated MIB tables and may return no information, when in fact 
most of the requested information is available. In some circumstances, provision of 
partial information may even result in agent non-responsiveness, crash, or lockup of 
the entire system. Consequently, the get request by the NMS fails and a possibly 
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erroneous error condition may be indicated. Therefore, there also remains a need in 
the art of SNMP managed networks for a system and method for supporting partial 
MIB population. 

Summary of the Invention 



additional advantages, by providing a system and method for accurately providing a 
uniform managed object listing in each managed device of a given class. In particular, 
each managed device of a specific type is grouped into a particular device class. A set 
of variables necessary to populate a local MIB for that device class are then defined as 
class attributes for the identified device class. The class attributes are then 
incorporated into the device driver for each individual device within the class. Because 
the device has been identified as a member of the class, when the agent requests the 
information for the local MIB, the class attributes are then called, resulting in the 
return of the requested information. 

[0010] The present invention also overcomes the deficiencies noted above by providing a 
system and method for supporting partial MIB population in managed devices. A 
default, working copy of all local MIB information is stored within the agent as default 
MIB values. Upon request by the agent for MIB information from the device, the default 
MIB values are only overridden when corresponding values are returned from the 
device. Consequently, all local MIBs will always be fully populated. 



[0009] 



The present invention overcomes the problems noted above, and provides 



Brief Description of the Drawings 



[001 1] 



FIG. 1 is a generalized block diagram illustrating an SNMP management system in 
accordance with the present invention. 



[0012] 



FIG. 2 is a block diagram illustrating one embodiment of a system for populating a 



MIB. 



[0013] 



FIG. 3 is a block diagram illustrating one embodiment of a system for supporting 
partial MIB population. 



Detailed Description of the Preferred Embodiments 



[0014] 



Referring generally to the figures and, in particular, to Fig. 1 , there is shown a 
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generalized block diagram schematically illustrating an SNMP management system 
100 in accordance with one embodiment of the present invention. In particular, the 
SNMP management system 1 00 includes a management entity 1 02 such as the 
network operator or service provider. Associated with the management entity 102 is a 
Network Management System (NMS) 1 04 which interfaces via SNMP with the various 
managed devices 106. Each managed device 106 includes a resident SNMP agent 108 
which, as described above, interfaces with the managed device to retrieve or modify 
device variables as requested by the NMS. Each agent 108 maintains a local 
Management Information Base (MIB) 1 1 0 relating to the managed variables for the 
device on which it is resident. The agent 108 interacts with the managed device 106 
to populate the local MIB 1 1 0 and relay any requested MIB information to the NMS 
104. 

[001 5] As set forth briefly above, prior to the SNMP agent's being able to populate its 
local MIB 1 1 0, each managed device 1 06 must be configured to include a set of 
defined variables for which it is responsible. In accordance with the present invention, 
managed devices 106 are categorized into various classes, where each class of device 
is responsible for the same types of MIB information. As will be set forth in additional 
detail below, the device driver for each device of a given class is then configured to 
include a class definition. The class definition consists of the various class attributes 
and attribute accessor methods (i.e., manners for retrieving the attribute values). In 
populating the local MIB 1 1 0, the agent 1 08 requests the values from the device 1 06, 
which, in accordance with the device driver, calls the established class methods and 
returns the requested values. 

.001 6] Referring now to FIG. 2, there is shown one embodiment of a managed device 1 06 
having the features briefly described above. In particular, each managed device 106 
includes an Agent 1 08 and a device support section 200. The device support section 
200 includes a device driver 202 which, in accordance with the present invention, 
includes an attribute class definition 204 for the class to which the device belongs. 
The class definition 204 defines the various attributes necessary for MIB population 
and, when queried, enables the device to return values for the defined attributes. 
Providing for the definition of MIB required attributes in the inventive manner enables 
device developers to quickly and easily meet SNMP requirements. Further, the 
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uniformity of the definitions across an entire class of devices significantly reduces the 
likelihood of providing missing or erroneous attributes to the MIB. 

[001 7] | n one preferred embodiment, the present invention may be implemented in the form of 
source macros defining the Class context variables, attributes, and accessor methods. Class 
membership is then obtained by using the macros. Exemplary embodiments of several 
macros are illustrated below. 

/•Adsl Class definition •/ 

tt (c) Copyright Virata Corporation 2001 
/* ClassAdal.h 

* adsl. Class attributes and accessor function definitions. 
•/ 



tfifndef 

#de£ine 



_CLASS_ADSL_H 
CLASS ADSL H 



This file must be included afcer the bun.h header file. 



* AD8L._CLaS3_ACCBSSOR_DBFN does not include any attributes from the ADSL, Class 

* which were (and are) present in this driver before it became a member. 

- since including them twice would not be sensible This particular driver 

* already had the "Connected", -Version". "RxBitRate" , "TxBitRate". 

* "RxCellRate", and "TxCellRate- atributes, so they are not duplicated here. 



/* AI>SL._CLASS_ACCBSSOR DBFN includes several types of accessor functions. Each 

* accessor function type is defined in file be_g992.c. The base accessor 

* type is ATTRIb_PN, which returns the value of a variable from the context 

* through the appropriate helper function. Accessor type ATTRiB_FN_G992_BE 

* returns a value from within the PHY, th« value is current it connected, and 

* historical otherwise. Accessor type ATTR I B_FN_G9 92_BE_CURRENT also returns 

* a value from within the PHY, the value is current if connected, and zero 

* otherwise. 



•define ADSL_CLAS3_ACCESSOR_DBFH 
ATTR I B_FK ( LineCodi ng, U32) ■ 
ATTR I B~FN (Line Type. 032) , 
ATTRiB_PN{AturlnvSerialHUinber, PTR) ; 
ATTR IB FN {AturlnWendorlD, PTR > ; 
ATTR1B_FW (AturlnvVersionNumber, PTR) , 



LASS_CUKR TX RATB) ; 



ATTRlB_™_G992_BB_COTREKT(AturCurrSnrMgn / S3 2 , ADSL CLASS CURR_SNR_MARGIN) ; 
ATTRIB_PM_G992_BS_CuRRENT(AturCurrAtn J D32. ADSL_CLASS_CURR_ATTRN) ; 
ATTRIB_PN {AturCurrScacus , PTR I , \ 
ATTRIB_FN (AturCurrOutputPwi. S32) ; \ 
ATTRIB__FN ( AturCurrAtta 1 nab 1 eRate , U32) j \ 
A TTR IB_FN_Q9 9 2_BE { Atu rChanRece 1 vedB Iks . D3 2 , ADSL_CLASS_BL0CK9_RX ) / 
ATTRIB_FN_G992_BE(AturChanTransmittedBlltB, 032, ADSL CLASS_BliOCKS_TX) , 
ATTRIB_FN_G992_BB (AturChanCorrectedBlks . U32. ADSL CLASS_hl£)C3CS_correctkd ) , 
ATTRIB FN G992_BB<AturChanUncorrectBl)cs. U32. ADSL_CLASS_BLOCKS_UNCORKKCTED) ; 
ATTRlB_FM(AturChanInterleaveDelay < 1132); 

ATTR I B^_PM_G 9 9 2_BE_CURRKNT (Atu rC hanCu r rTXRa t e , 032, AHSLj 
ATTR I B_PN (AturChanPrevTxRate, U32) / 
ATTR IB_PN ( AturChanCrcBlockLengt h , U3 2 ) , 
ATTRIB_PN< AturChanPerf Validlntervals. U32) ; 
ATTRIBPN (AtuiChanPerf Invalid Interval*. 0321 / 
ATTRIB_FN (AturChanPerf CurrlSMinTimeBlapsed, U32) , 
ATTR I B_FN ( A turChanP erf Cu r r 1 SMi nRece i vedB Iks , U32J / 
ATTR Ibfh {AturChanPerf Cur rlSMlnTranomittedfilks. 032) ; 
ATTRlB_FN{AturChanI»erfCurri5KinCorrectedBlks, U32) » 
ATTRI B_PN ( A tur ChanPe r £ Cur r 1 SKin Uhcor r e c t Bl ks , CI32) ; 
ATTRIB_FW (AturCkanFerf CurrlDayTimeBlapsed, U32) ; 
ATTR1B_FN (AturChanPerf CurrlDayReceivedBlks, U32) ; 
ATTRlB_PU(AturChanPerfCurrlDayTransmittedBlks. U3 2) ; 
ATTR IB FN (AturChanPerf CurrlDayCorrectedBlks . 032) ; 
ATTRIBFN (AturChanPerf CurrlDayUncorrectBlka , U32) , 
ATTRIB_FN {AturChanPerf PrevlDayMoniSecs, D32) , 
ATTRIB_FN (AturChanPerf PrevioayReceivedBlks, U32) , 
ATTR1B_FN (AturChanPerf Pre vlDayTransnictedBlks. U32) ,• 
ATTR I B_ FN (AturChanPerf PrevlDayCorrectedBlks . U32) } 
ATTRIB_FN(AtuTChaiu?erfPrevlDayOncorreccBlks. 032) ; 

•define ADSL_CLASS_VXRIABLES 
032 Line Coding i 
U32 LineType, 
PTR AturlnvSerialHumberr 
PTR AturlnWendorlD; 
PTR AturlnWersionNumber; 
S32 AturCurrSnrMgn; 
D32 AturCurrAtn, 
PTR AturCurrStatua ; 
U32 AturCurrOutpucPwr; 
U32 AturCurrAtta inabl eRate/ 
D32 AturChanReceivedBlksj 
032 AturChanTransmittedBlkei 
U32 AturChanCorrectedBlkSr 
U32 AturChanUncorrectBlks; 
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U3 2 AtmrChanlntBrloaveDelay; 
U32 Atur ChanCur rTxRa C o ; 
U32 AturChanPrevTxRate, 
U32 AturChanCrcBloekLength; 
U32 AturChanPerfValidlntervalo; 
U32 AturChanPerflnvalidlncervala/ 
U32 AturChanPerfCurtlSMinTxinisBlapBod; 
U32 AturChanPerfCurrlSMinRecelvedBlka,- 
U32 AcurCnanParfeurrlSMinTrananuttedBlke; 
U32 ALuxCThnnPerf Cvirrl SMinCon-ectrdBlkS; 
U32 AturChanPerfCurrlSMinUticorreccBlkaf 
to 2 AturChanPerfCurrlOayTimeElapaed; 
C32 AturChanPerfCurrlDayRaceivodBlkai 
U32 AturChajiPerfCMrrlDayTransmittedBlks, 
U32 AtuxChanParfcurrlDayCtozT-ectedBlko; 
U3 2 AturChajiPerfCurrlDayOneorreceBlka; 
U32 AturChanPerfPrevlDayMaiiiSacai 
U3 2 AturChanPer f PreviDayReceivedBlka » 
03 2 AcurChanPerf PrevlDayTranBxni ttedBlks ; 
(73 2 AturChanPerf PrevlDayCorreccedBlks ; 
U32 AturChanPerfPravlDayUncorraetBlkaf 

Kde f me ADSL_CLAS S__ATTR I BOTE_DBFN 

ATTRIB_DEFM ( 'LineCodiog- , LineCoding, U32, Readonly). 
ATT8iB_DEPH(-Lit»eTypa-, LineType. t»2. Readonly), 

ATTRIB_DEPN<«AcurlnvSerialNumber«, AturlnvSerialWumber, PTR. Readonly), 

ATTRlB_DEPN(»AturInWendorID". AturlnWendor ID . PTF. Readonly), 

ATTR IB_DKFTtf f "Ac urlnWe ttm i onWumber- , AturlnWeralonWumber. PTR, Readonly). 

ATTRIB__DEFN ( * AturCurrSnrMgn" , AturCurrSnrMgn, S32, Readonly), 

ATTRIBDEFN ( -AturCurrAtn* , AturCurrAtn, U32, Readonly), 

ATTRIB_DEFN ( "AturCurrSt atuo - , AturCurrS tatua , D3 2 , ReadOnl y ) , 

A1TH 1 1J_DEPN { - AturCurrOutput Pvr" , AturCurrOutputPwr. S32. Readonly), 

ArTRIB_DBFH("AturCurrAtCainableRate-. AturCurrAttainableRate, U32, Readonly). 

ATTRlB_DEFHCAturCHanRecelvedBlka«. ArurChanReceivedBlk©. D32, Readonly), 

ATTRIB^DEraCAturChanTranamittadBllca-. AturChanTranemittedBlka, U32, Readonly). 

ATTRIB_DEPN(«AturChanCorreccedBlk9", AturChanCorrectedBlks. U32. Readonly), 

ATTRIB_DKPNCAturClianUncorrecCBlka-, AturChanUncorrectBlks. U32. Readonly). 

ATTHIB_DEFN(-AturChaiilnterleaveDelay». AturctaanlnterleaveDelay, U32. Readonly). 

ATTRIB_DBFN i "AturCbanCurrTxRate* , AturChanCurrTxRate, U32. Readonly), 

ATTRIB_DETO(-AturChanPrevTxRate-, AturChanPravTxRata, U32. Readonly), 

ATTRIB_DBPN(-ACurChanCrcBlockI.en9th-, AturChanCrcBlcckLength, U32, Readonly), 

ATTRIB_DEFH{-AturChanPerfValidIntervalB". AturChanPer* Valldlnterva Is. U32. Readonly). 

ATTRIB_DEPN(-AturChanPerflnvalidIntex-vrale''. AturChanPertlnvalidlntervala, U32, Readonly). 

ATTRIB_DBPNCAturChanParfCurrl5MinTimeEl a psed". AturChanParf CurrlSHinTxmeBlapsed. U32. Readonly), 

ATTRIB_DBFN(-AturChanPer£Currl5Mi.nRacelvedBlk s -. AturChanPerfCurrlSMinReceivedBlks, U32. 
Readonly) , \ 

Q * 1 ^ 4 IB - DB f N <" Aturt:hHn P«r*Currl5HlnTransmitCedBlkfl-, AturChanPerf CurrlSMlnTrananuctedBlks, U12, 
Keaaonly) , \ 

ATTRIB_DBFN(-AturChanParfCurri5MinCorrectedBlka-, AturChanPerfCurrlSMinCorrectedBlka, 032 
Readonly) , \ ' 

ATTRIB^DBPNCAturChanPerlCurrlSMinimeorrecCBlks-, AturOianPerfCurrlBMinOncorrectBlka, U32 
Readonly) . \ 

ArrRIB_DBPN(«AturCnanPer£OaririnayTimeEla P aed-, AturChanPerf CurrlDayTimeElapaed. U32. Readonly). 
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^ ATTRIBJJEFN<-AturChanFerfC«rrlDayReceivedBlks-. AturChanPerf CurrlDayReceivedBlke. U32, Readonly). 

ATTRlB_DeFMrAturCbanPerfCurrlDayTran«mittedBlX8-. AturChanPerfCurrlDayTransmittedBlka, U3 2. 
Readonly) . \ 

ReadOalJ) B ~ DEFN{ " At \ rCh * IlPerf CurrlDayCorrecCedBl,c8 " • AturChanPerf CUrrlDayCorrectedBlkjj, 032, 

ATTRlB_DEPH<-AturChanPorfCurriDayUlicorrectBlk«-. AturChanPerf CurrlDayUncorreccBlks, U32. 
Readonly) , \ 

^ ArTRIB_DEF*( AturChanPerf PrevlDayMonifiecs-. AturChanPerf PrevlDayMoniSecs, U32. Readonly), 

^ ATTRI8_DEFN( "AturChanPerf PrevlDayReceivedBlkB". AturChanPerf PrevlDayR«cei vedBlks, 032, Readonly), 

ReadOnTJ) B ~ DEFN \" AtUrChanP<,rl PreWDa ^ ranfi,,i1:t:e<1Blks ' • AturChanPerf PrevlDayTransmittedBlka. 032, 

ATTRTB_DBPNCACurchanPerfPrevlDayCorrectedBlkB' . AturChanPerf PrevlDayCorrectedBlks, D32 
Readonly) , \ ' 

* ^W^JSS-i*^ AturChanPerrPrevlDayUncorreccBlka . U32. Readonly) 
/* Adsl Class mcmfcenhip insandauoo */ 

* <c) Copyright Virata 2000, 2001 

* »#»ff«#*»**»*t»#*#»««»t«»«ti»«il«*##«M*0*|f#irt*tt««#i»*M##««ft««Mtt«t«0ft«*«#*/ 

/* be_g992.c 

* BUN G.992 Physical Interface Driver: Beryllium- specif ic implementation 
•/ 

I 

I 



typedef a cruet 
{ 

BOOL sharedavall, 

BOOL open; 
U32 Status; 

U32 powerState; 

PTR pOwerChangeCallback; 

PTR powerWakeCallback; 

cha r phyVe ro ion f G 9 9 2 PHY_MAXVERS ION] ; 



/* G.992 shared info available 



' G.992 port open state */ 

* G.992 line state */ 

■ The G.992 line power state •/ 

' G.992 power change callback */ 

G.992 wake callback •/ 

The G.992 PHY version string */ 



• Tracking the bun information. 
*/ 

tBunPort -pBunPort, 
tBunChannel •pflunChannelj 



A pointer to the BW port 
A pointer to the BUN channel 



/• Add port -specific information here */ 

struct 

{ 

AOSL_CLASS_VARIABLES 
#i f de f SNMPR M I BSUPPORT_ADSL_MI B 

snmpIfEncry_c SnmpT t Entry > 
#endif /• JJifdef SNMPR_MIBSOPP0RT_AD3L_MIB */ 
) attributes! 

> tG992Port; 
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* Accessor functions for default (base) attributes 

idefine FN KAME(v) g992_attrib_ #« _v 

/♦ Basic Accessor */ 
idefine ATTRlB_PtJ(_v, _t) \ 

Static int FN NAME ( v) (fcBunAttributeOp op. tBunAttributeArgs* pArga, void* pContext) \ 
(return bun_AttributeHelper i« _c (op, pArgs, & ( ( (tG992Port*) pContext) -attributes. v )),} 

/* 

* Accessor for values within the PHY: returns current value it connected. 

* and past values otherwise. 
*/ 

tf define ATTRIB_FN_G992_BB(_v, _c. _m) ^ 

?5f! iC lnt n *_ MM <EC v ) (tBunAttrabuteOp op, tBunAttritouteArgs* pArgs, void* pContext) \ 

{U32 Value - 0; UNUSED (pContext > ,- \ V ' X 

if ( 3 992 be^aOmnectedO) {Value - _ ra , ( < t G9 92Port*) pContext) - >at tributes, v- (t)Value,} \ 

else {Value - (U32) ( (tG992Port-> pContext )- >at tributes . v| \ " ~ " N 

return bun_AttributeHelper ## _c (op. pArgs, &Value);) ~ 

/• 

* Accbbbqi for values within the PHY: recurna current value if connected 

* and zero otherwise. 
•/ 

idefine ATTR I B_ FN_G 9 9 2_BE_CURRENT { __v , t. _m> » 
static mc PN_NAME (_v> (tBunAttributeOp" op, tBunAttributeArgs* pArgs, void- pContext) \ 
{032 Value - 0; UNUSED (pContext ) .- \ *vwws«w * 

iL (9 "l- be T^ BC0 ^ neC ! :e f {)) {ValU ° '«tG992Port*> pContext) -attributes . v - ( t } Value t J \ 

return bun_AttnbuteMelper ## _t (op. pArgs, bValue) ; } ~ ; ' % 

s?«or(™ I ^!SS B T!;>-r ~' ~ n 1 -"' ^^libuLwReyTypea ** ^unAtcibuteKeyrlags „ _t. 
tfdefine ATTRlB_D X FN_o5jBCTC^n. _s. _f) { kBuoAttributeKeyTVpesObj ect . kBunAttributeKeyPlagsNone, 

I 

[ 

/• Declare ADSL, class attribute accessor functions. 
V 

ADSL__OLASS_ACCESS0R_DE FN 
/* 

* List of port attribute keye 
*/ 

tBunAttributeKeyDefinition g992BePorcKeyDef na fJ *» 

{ "Version-, XBunAttributeKeyTypes version, 
KBunAttrxbuteKeyFlagsReadOnly. sizeof (int), g992_AAPVeraion }, 

{ "PhyVersion". kBunAttributeXeyTypesString, 

KBunAttrlbuceKeyFlagsReadOnly, G992phy_naxvbrSION. g992_AAPPhyVersion }, 

f "Open", xBunAttributeKeyTypeaBOOL., 

KBunAttributeKeyPlagBNone, sixeof (BOOL). g992_AAPOpen }. 

{ "Reset", kBunAttributeKeyTypesBOOL, 
xBunAttrabuceJCeyPlagsNone, azzeof (BOOL), g992_AAPReset J, 

{ "Connected". kBunAttnbuteKevTypeHBOOL, 

JcBunAttributeKeyFlagsReadOnly. sizeof (BOOL) , g992_AAPConnected \. 

{ "Powerstate", kBunAttributeKeyTypesEnum, 

KBunAttributeKeyFlagsMone. aizeof(U32), g992_AAPPowerState >, 

{ "PowerChangeCallback", XBunACtributeKeyTypesPTR, 

kBunAttributeiCeyPlagsNone, sizeof (ptr), g992_AAPPowerChangeCallback J, 

{ "PowerKakeCallback", kBunAttributeReyTypesPTR, 
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kBuxiALtributeKeyPlagoNone. sizeof (PTRI, g992_AAPPowerWake Call back ), 

{ ■RxBitRate". kBunAttr:ibuteKeyTvpeaU32, 

kBunAttributeKeyPlagsReadOnly, sizeof (U32), g992_AAPDownstreamBitRate ), 

{ "RxCBllRate", kBunAtcribviteKeyTypesU32 . 

JcBunAttributeiCeyFlagsRaadQnly, sizeof (ITJ2) , g992_AAPDownHcreamCellRate ). 

{ -TxBitRate", fcBunArtrlbuteKeyTypeeU3 2, 

kBunAttributeJOyFlagsReadOnly, sizeof {U32> . g992_AAPtJpstreamBitRate }. 

( "TxCellRate-. kBunAttributeKeyTYpesU32, 

kBunAttributeKeyPlagsReadOnly, sizeof (U32), g992_AAPUpstrearaCellRate ), 

{ " Downs treaaParamet era", kBunAttrinuteXeyTypeBObject, 

kBunAttributeKeyPlagsReadOnly. svieof (G992 D0WN8TRRAM_PARAH3 ) , 
g992_AAPDawnstraaraParametere ), 

{ "DownstrearaStatietics-, kBunAttrihuteKeyTypesObject, 

kBunAttributeKeyPlngsReadOnly, si xeof <G992_DOWNSTREAM_STATS) , 
g992_AAPDowastreamStatiseics }, 

( "UpstreamParameters". kBunAttributeKeyTypesObject, 

kBunAttributeKeyPlagsReadOnly. si xeof (G9'J 2_UPSTREAM PARAMS ) , 
g992_AAPUp8treamPararaeters }, 

( -UpstreanStatistics-, kBunAttributeKayTypesObjeCt, 

kBunAttributeKeyPlagsReadOnly. a i xeof (G9 9 2_UPSTREAM_STATS ) , 
g992_AAPUpatreamStatiseicB }, 

( "Traimnglnfo", kBunAttributeKeyTypeaOb ject , 

k&ujiAttributeKeyFl.agsK«adOnly, sizeuf ( G9 9 2_TRA IN ING_ I NFO ) , 
g992_AAPTrainlngInfo }. 

AD8L CLASSATTRIBUTK DEPN, 

B07J_CLASS_ADBP_ADSL , ~ 
tifdef SKMPR_MIBSOPPORT_ADSL._MIB 

BUN_ATTRIBOTE_KEYDKPN_I«CMn>B ( " i f Bnt ry" . &snrapSupport_BunI f EntryAtt ribut ea) , 
#ftndif /* #i£def SMMFR_MlBSUPPORT_ADSU HIB */ 

BUN ATTRIBUTE KBYDBPN END 

h 



/* Adxl ClaM MTB population */ 

fill Ii\_ChanPerf DataEntry (void *table, SR_IKT32 iflndax) 

if { NULL. I- { ads lAturChanPerf Data Entry_fc *) Cable ) 

static adslAturChajiPerfDataEntry_t *padelAturChanPerf DataEntry ; 

padalAcurChanPerf DataEntry « (adslAturChanPerf DataEntry t *) table; 

snrapSupport_IcAtt rGetData (If Index. 

"AturChanReceivedflDu" , 

ipad a 1 AturCbanparf DataEnt ry - >ada 1 AturChanRe c e tvedBlks , 

aixeof (padalAturChanPer£DataEntry->adolAturChaiiReceivedBlk8) > t 

enmpSupport_l fAtt rGetData <lf Index, 

"AturCbanTranstnittedBlks" . 

&padalAturChanPerf DacaEilt ry- >adslAturChanTranBmitt«dBlkB . 

Bixeof (pad^lAturChanPerfDataEDtry->adalAturChanTransralttedBlks) > ; 

anmpSupport_I fAtt rGetData U f Index, 

"AturChanCorrectedBlks" , 

SpadalAturChanPerFDataEncry- >adslAturChanCorroctedBlka , 

si zeof {pads lAturChanPerf DataEntry- >adelAturChanCorrectedBlka > > ; 

BnmpSupport^I fAtt rGetData (if Index, 

"AturChanOhcorrectBlka" , 

fcpadelAturCbanPerfDacaBntry->adslAturChanlJhcorrectBlka, 

aixeof {padslAcurChanPerfnataKntry->adslAturChanUncorrectBlka) ) ; 

BnmpSupport_IfAttrGetData (iflndax, 

■AturChanPerf Val idlntervala- , 

4padalAtui^anPerfDataBntry->adslAt\irChanPereValidInterval8. 



sizeof ( pads 1 At urChanPerf DataEntry- »adslAturChanPerrval id Intervals} 

snmpSupport_If Ate rGetData (if Index, 

"AturChanPerf Invalidlntervals" . 

tpads lAturChanPerf DataEnt ry- >adol AturChanPerf Invalidlntervals, 
sizeof (pads lAturChanPerf Da taBncry->adslAturChanPerf Invalidlntervala) 

padalAturChanPerf DataEntry- »if Index - if Index; 
/• 

• If all of the variables for this table are not supported, the "valid" 

• field bits must be explictly set or cleared (instead of using Che 

• SST_ALl,_VALID(vf ) macro). Clear the •valid" field bits for the 

• variables which are not supported, and set the -valid- field bitB for 

• Che variables which are supported. The -valid- bits are manipulated 

• from function k_adfi lAturChanPerf DataEntry_get . 



As described briefly above, due to various conditions, managed devices may not 
support all variables required by an SNMP agent in populating its local MIB. In such 
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circumstances, the back-end MIB compiler would fail to include such values within the 
MIB. Consequently, since all required information is not present, the SNMP agent 
would identify the local MIB as a bad MIB and indicate such identification to the NMS 
resulting in an erroneous error condition being identified. In accordance with the 
present invention, such an occurrence is prevented. 

[0019] Referring now to Fig. 3, there is shown a block diagram illustrating one 

embodiment of a system for supporting partial MIB population in accordance with the 
present invention. The invention provides a method for partial table support (a table 
may be partially implemented intentionally, from the MIB back-end, or unintentionally 
with respect to the back-end designer, when the information provider (which may be 
beyond the control of the back-end designer) fails to implement a variable or method 
corresponding to a MIB object. Contrary to the conventional approach, the 
Agent/back-end MIB compiler 302 statically allocates a default device information 
table of the types to be partially supported. This becomes the default values for the 
management information base table, for those attributes permitted to not be included 
or supported by the managed device. In response to a SNMP Get request from the 
agent, the MIB table is populated with information from the device, if available. 
However, if information is not available for a particular object, that entry in the table is 
set to an appropriate value from the statically allocated default device information 
table of the types to be partially supported. This results in a fully populated MIB table, 
even where all objects were not retrieved from the device. The fully populated MIB 
table is then forward to the NMS 304. When the Agent is done handling the get 
request, a pointer is returned to the statically allocated table. 

[0020] Essentially, by setting defaults for particular non-essential objects, the failure of 
the device to return values for these objects will not result in an agent malfunction, 
crash, or erroneous transmission to the NMS. 

[0021] 

While the foregoing description includes many details and specificities, it is to be 
understood that these have been included for purposes of explanation only, and are 
not to be interpreted as limitations of the present invention. Many modifications to 
the embodiments described above can be made without departing from the spirit and 
scope of the invention, as is intended to be encompassed by the following claims and 
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their legal equivalents. 
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